home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1999 May / SGI IRIX 6.5 Applications 1999 May.iso / dist / arraysvcs.idb / usr / share / catman / a_man / cat1m / arrayd.z / arrayd
Text File  |  1998-10-27  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaarrrrrrrraaaayyyydddd((((1111mmmm))))                                                          aaaarrrrrrrraaaayyyydddd((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      arrayd - array services daemon
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaarrrrrrrraaaayyyydddd [_o_p_t_i_o_n_s]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _a_r_r_a_y_d is the array services daemon.  It performs several different tasks
  16.      related to the use of an array of two or more machines, such as:
  17.  
  18.      - Allocating global array session handles
  19.  
  20.      - Forwarding "array commands" to all of the machines in an array
  21.  
  22.      - Maintaining a database of the current array configuration and providing
  23.        that information to other commands and programs
  24.  
  25.      - Determining which processes belong to a particular array session and
  26.        providing that information to other commands and programs
  27.  
  28.      For more discussion of these services, see _a_r_r_a_y__s_e_r_v_i_c_e_s(5).
  29.  
  30.      The _a_r_r_a_y_d command itself has several command line options.  The valid
  31.      options include:
  32.  
  33.      _----_cccc     "Check": causes arrayd to read any configuration files then exit
  34.             immediately, sending any errors to stderr rather than syslog
  35.             (which is the usual behavior).  This is primarily of use for
  36.             checking the validity of new configuration files.  This is the
  37.             same as the _----_qqqq_ffff flag.
  38.  
  39.      _----_ffff _f_i_l_e_n_a_m_e
  40.             Specifies the name of a single configuration file.  This option
  41.             may be specified more than once, in which case the files will be
  42.             processed in the order that they are specified.  One reason to
  43.             have multiple configuration files would be to allow all of the
  44.             machines in an array to use a single file (accessed via NFS,
  45.             perhaps) for array entries and still maintain private
  46.             configuration files for local options and/or security information.
  47.             The format of an arrayd configuration file is described in
  48.             _a_r_r_a_y_d._c_o_n_f(4).  If no configuration files are specified, then
  49.             "/usr/lib/array/arrayd.conf" and "/usr/lib/array/arrayd.auth" will
  50.             both be used (in that order).
  51.  
  52.      _----_mmmm _n_u_m_b_e_r
  53.             Sets the "machine identifier" used by the array services daemon
  54.             for generating global array session handles to _n_u_m_b_e_r.  Certain
  55.             versions of the IRIX kernel may also use this value when
  56.             generating array session handles.  _n_u_m_b_e_r must be a value between
  57.             0 and 32767.  It will override any IDENT setting in the LOCAL
  58.             section of any configuration file.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrrrrraaaayyyydddd((((1111mmmm))))                                                          aaaarrrrrrrraaaayyyydddd((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      _----_nnnn     Ordinarily, arrayd will automatically "daemonize" itself, that is,
  75.             dissociate itself from the current terminal and place itself in
  76.             the background.  Specifying this option will cause arrayd to run
  77.             in the foreground on the current terminal.  This is mostly useful
  78.             for testing purposes.
  79.  
  80.      _----_nnnn_ffff    Do not read any configuration files.  This is most useful with
  81.             options like _----_ssss_mmmm that cause _a_r_r_a_y_d to quit after performing tasks
  82.             that do not require configuration information.  _----_nnnn_ffff will override
  83.             any _----_ffff options.
  84.  
  85.      _----_nnnn_mmmm    Do not set the system machine ID.  This is used to override a
  86.             "LOCAL OPTIONS SETMACHID" statement in the configuration file.
  87.  
  88.      _----_pppp _n_u_m_b_e_r
  89.             This specifies which port the array services daemon should listen
  90.             on for requests.  It will override any PORT setting in the LOCAL
  91.             section of any configuration file.
  92.  
  93.      _----_qqqq_ffff    Quit after parsing the configuration file(s).  This is the same as
  94.             the _----_cccc option.
  95.  
  96.      _----_qqqq_mmmm    Quit after setting the system machine ID.  Causes _a_r_r_a_y_d to exit
  97.             as soon as it has set the system machine identifier (or would have
  98.             done so, in the case where this operation is not supported by the
  99.             current OS release).  This may be useful in cases where a non-
  100.             default system machine identifier is desired, but none of the
  101.             other array services provided by _a_r_r_a_y_d are needed.  This can also
  102.             be used to change the machine identifier on a system that is
  103.             already running another copy of _a_r_r_a_y_d; in this case, kernel-
  104.             generated array session handles will use the new machine
  105.             identifier while those generated by _a_r_r_a_y_d will continue to use
  106.             the original machine identifier.
  107.  
  108.      _----_ssss_mmmm    Some versions of IRIX permit setting a system "machine
  109.             identifier", which is used by the kernel for generating global
  110.             array session handles.  If the current system has this facility
  111.             and _----_ssss_mmmm is specified, _a_r_r_a_y_d will set the machine ID to the value
  112.             specified by a LOCAL IDENT statement in the configuration file or
  113.             on the command line using the _----_mmmm option.
  114.  
  115.      _----_vvvv     "Verbose": the daemon will run in the foreground (as with the -n
  116.             option) and will send any error messages, plus some additional
  117.             messages, to stderr rather than syslog.  Specifying this option
  118.             more than once or specifying more than one "v" (for example "-
  119.             vvv") will cause additional debugging information to be generated.
  120.  
  121. NNNNOOOOTTTTEEEESSSS
  122.      _a_r_r_a_y_d can be set up to run automatically at system initialization time
  123.      by using the _c_h_k_c_o_n_f_i_g(1M) command to turn on the aaaarrrrrrrraaaayyyy feature:
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaarrrrrrrraaaayyyydddd((((1111mmmm))))                                                          aaaarrrrrrrraaaayyyydddd((((1111mmmm))))
  137.  
  138.  
  139.  
  140.             _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg _aaaa_rrrr_rrrr_aaaa_yyyy _oooo_nnnn
  141.  
  142.  
  143.      When run in this manner, _a_r_r_a_y_d will take its command line options from
  144.      the file /etc/config/arrayd.options.
  145.  
  146. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  147.      array(1), arrayd.conf(4), array_services(5).
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.